Developer Documentation

QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Cones

A cone is a three-dimensional object defined by an origin (that is, the center of the base) and three vectors that define the orientation and the major and minor radii of the cone. A cone is defined by the TQ3ConeData data type. See "Creating and Editing Cones" for a description of the routines you can use to create and edit cones. Figure 34 shows a cone.

Figure 34 A cone

typedef struct TQ3ConeData {
    TQ3Point3D                          origin;
    TQ3Vector3D                         orientation;
    TQ3Vector3D                         majorRadius;
    TQ3Vector3D                         minorRadius;
    float                               uMin, uMax, vMin, vMax;
    TQ3EndCap                           caps;
    TQ3AttributeSet                     interiorAttributeSet;
    TQ3AttributeSet                     faceAttributeSet;
    TQ3AttributeSet                     bottomAttributeSet;
    TQ3AttributeSet                     coneAttributeSet;
} TQ3ConeData;
origin
The origin (that is, the center of the base) of the cone.
orientation
The orientation of the cone. This vector also specifies the height of the cone.
majorRadius
The major radius of the cone.
minorRadius
The minor radius of the cone.
uMin
The minimum value in the u parametric direction of the cone. This value should be greater than or equal to 0.0 and less than or equal to 1.0.
uMax
The maximum value in the u parametric direction of the cone. This value should be greater than or equal to 0.0 and less than or equal to 1.0.
vMin
The minimum value in the v parametric direction of the cone. This value should be greater than or equal to 0.0 and less than or equal to 1.0.
vMax
The maximum value in the v parametric direction of the cone. This value should be greater than or equal to 0.0 and less than or equal to 1.0.
caps
The style of cap to be used on the cone base. See "End Caps Masks" for a description of the masks you can use to specify a value for this field. For a cone, the value kQ3EndCapMaskTop is ignored.
interiorAttributeSet
A set of cone interior attributes.
faceAttributeSet
A set of cone face attributes.
bottomAttributeSet
A set of cone bottom attributes.
coneAttributeSet
A set of attributes for the cone. The value in this field is NULL if no cone attributes are defined.

© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |